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INTRODUCTION 


This memo describes the practical ImplementatIon of 
programs written In the language EUTERPE* Details of this 
language are given In the author 1 * thesis O' A Parallel 
Processing Model of Musical Structures") and will not be treated 
here. We shall only be concerned with the preparation and 
processing of a EUTERPE source program* Sample programs are 
given In their entirety In the thesis or may be read off the 
author's file directory (SWSj). Notations! conventions are 
those of Dawson's guide to the A * 1* Lab timesharing system (A* 
I, Memo No. 215)* 

The EUTERPE system consists, essentially, ]n five stages 
of operation* These are. In summary, as follows: 

1) Preparation of a source file* This Is basically the 
"EUTERPE program, 11 l*e. the representation of a piece of music 
In the EUTERPE language* 

2) Assembly* In order to be run, a EUTERPE program must 

■k. 

be assembled Into a binary file which Is actually loaded Into 
the computer* 
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3} Debugging* A EUTERPE binary Is normally loaded Into 
tbe PDP-G; and as It Is running, this computer plays the music 
represented by this program. The execution of the program 
Involves a real-time interpretation of EuTEftPE'a si* voice 
programs which Is monitored by DOT* a debugging facility* (This 
DDT Is not to be confused with the DDT which monitors the ITS 
timesharing system; It Is a special DDT which runs only In the 
PDP-G.) This DDT has facilities to aid the debugging of EUTERPE 
programs* 


4) Compiling. because this binary file runs 
Interpreted* the sound which Is produced has certain distort lens 
due to the timing of the tntepreter* These may be overcome by 
preparing a como fled version once the program is debugged, 

5) Playing compiled music* The PDP-G Is again the 
"Instrument; 11 however* the monitor for this player runs In the 
timesharing system* 1| Is also compatible with the music 
compiled by Peter Samson's MUSCOM (A, 


I. Memo No. 107)* 
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PREPARATION OF A SOURCE FILE 

A EUTERPE source program should be written as a TECO 
file which win then be assembled by MFBAS. In order for the 
program to be properly processed It Is necessary to assemble the 
Interpreter for EUTERPE Instructions along with the source 
program* This Is achieved by beginning the source file with 
the command: 

♦INERT EUTERP; EUTERP > 

This will supply the latest working version of EUTERPE. (Recent 
not-necessarlly-workIng versions will have user name SWS.J 
Programs for the sIk voices may be Inserted following this 
command. Since a program for voice n Is to begin at address 
VOICEn, this program should be preceded by the MIDAS pseudo¬ 
operation LOC VOlCEn. For example, here Is the beginning of a 
EUTERPE program: 

TITLE MODULI EftENDER t \ RltELCANON 

.CNSfil EUTERP;EUTERP > 

■% 

LOC VOlCEl ;CANTUS FlRMUS 

WAVE ALL,SQUARE ;ALL VOICES SOUND SQUARE WAVES 
HOVE I I,G ACCUMULATOR COUNTS SIX REPETITIONS 

K C -4D ;NOTE WORDS FOR CANTUS FlRMUS 

K D ST 


Finally, the file should end with the command: 


END TUNE 
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ASSEMBLY 

The actual assembly of a EUTERPE source file Is 
accomplished by MIDAS In the seme manner as the assembly of an 
ordinary assembl y-1 anguage file. Persons unfamiliar with MIDAS 
may easily assemble their programs by typing the following 
Commands from DDT t 

MIOAS ctrt K 

fIlenamel^fIlenamtier 

This will create a binary file called filename! BIN which may 
either be rub Interpreted on the PDP*S or run In ITS to produce 
a Comp!led file* 

MIDAS error messages are listed In Peter Samsor^s MIDAS 
memo (A. I. Memo Wo* SO); however, there Is one error for 
which no message Is given* If a EUTEfiPE program Is too long, 
there may not be enough room for It In the PDP'-E * When MIDAS 1$ 
completed. It gives the addresses of the core assigned to 
generated constants. If this area extends higher than 30000, 

ft. 

there Is a denser that It win conflict with DDT; and the 
program should be broken Into smaller segments* 
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DEBUGGING 

The Interpreted execution of a EUTERPE binary plays 
music using two 9-fa3t d-to-a converters* Jt Is loaded Into the 
FDP-6, a I ode with a GOT, by TEN LOO. By way of example, the 
EUTERPE binary file f I (enamel BIN would be loaded by typing the 
following to the timesharing DDT: 

TENLQDcfcrLK 

L fIlen&mel_aINcr 

F 


The last command actually starts the DDT In the PDP-6 
running, TENLOD may type out one of two critical error 
messages* T, PDP-10 NOT AVAILABLE' 1 means that some other user 

has the PDP-B* "RUNNING?" may be typed In response to the F 
command. This may or may not mean the PDP-B Is not running* 
Check the RUN light on the PDP^G control panel Cbelow the 
mlcrotape drives; It Is labeled RUN). If It Is on, TENLOD Is 
probably confused* If It Is off, depress the INSTRUCTION STOP 
switch (and! restore to center position) on the PDP-6 control 
panel; and do the same for the 10 RESET switch. Set the 

address switches to 3LGQ0, and depress the START switch. DDT 
should now be running In the POP-G* 
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The best way to communicate with the DDT in the PDP-6 is 
to use T4, the teletype at the PDP™G console. On the left side 
of the 34D display Is a toggle switch In the up position* 
Depressing this snitch causes this teletype to communicate 
directly uv T ch the PDP-&, rather than with ITS. When this snitch 
Is in the down posit[Ion, the user Is ready to type commands at 
the DDT In the POP-G. 

Unfortunately, there Is no available documentation for 
the PDF-G DDT* The novice would do well to consult the section 
on DDT In DEC's P D_P| jj Reference Handbook j most of the baste 
debugging facilities mentioned therein are identical to those of 
PDP-G DDT. Also, Tom Knight's A* i* Memo No. 147 lists most of 
the DDT Instructions but also Includes commands for the 
timesharing monitor, (N.B. For purposes of using PDF-G DDT, A. 
I. Memo No. 147 Is far preferable to Its revision, A. f. Memo 
No, L47A; get It before It disappears.) 

Before running a EUTERPE program, the amplifier and data 
switches have to be set for monitoring the d-to-a converters. 
Turn the amplifier on and set It to channel AUX2 with relatively 
high volume* It is desirable to lower the treble and boost the 
bass because of the rather nasty sound which these d-to-a 1 s 
currently make. Finally, the address switches should be set to 


20 
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To start the EUTERPE program playing, typo TUNE (£) G; the 
program hill now play to Its completion, after which control 
will be returned to DOT. On subsequent occasions, the player 
may be started by typing SETUP (J) G- The player may be stopped by 
typing a Space, 

EUTERPE lias eight breakpoints which cause a temporary 
interruption of the program. To enable these breakpoints, typE 
EUBRK(AA) (T) Ek To assign an address to a breakpoint, type 
BREAKS+n/, where n ranges from 0 to 7* Then type the address 
which Is to be the location of the break. When any voice 
program encounters that address, the playing will stop; and 
control will return to DOT/ which will type out the address of 
the break. To resume playing from that breakpoint, type(pP. 

Some bugs are more fatal than others. Some, for 

example, may prevent returning control to DOT* DDT may be 

restarted From the PDP-6 console by hitting INSTRUCTION STOP, 10 

RESET, setting the address switches to 3kOCQ, and hitting START. 

£Don 1 1 forget that the address switches must be set to 2 0 for 
% 

listening to music.) If this succeeds, the teletype will respond 
with a reassuring carriage return and line feed. if (t fails, 
DDT has been clobbered and It Is necessary to reload the PDP-&. 
Flip the teletype toggle switch up again, and type ct rl X. 


This 
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restores TENLCD 1 *: attention, aiul you can proceed exactly as If 
you had typed rENLQO etrl K* (Short cut: If you just type L cr, 
TENLQQ Mill load the same file Et loaded on the last L command*) 

If you do not have access to T4, the situation Is not 
hopeless, although It Is much more painful* You will have to be 
\n the vicinity of the PDP-6, not only so that you may hear the 
loudspeakers, hut also to be able to readily access the PQP-B 
console. From TENLQD first type 10 (this Is the letter 0); 

TEHLOD will respond with a carriage return and line feed, after 
which you type an L command as above. Then type PF Instead of 
F, and your teletype Is now communicating with the DDT running 
In the PD P-6. Things may now proceed exactly as above, except 
that hittInc a space will not Interrupt the PPP*G playing music. 
To do this, you have to stop the computer from Its console and 
restart at 34000 (following the same procedure given above In 
case the program hangs up)* To get back to TEN L0&, type ct r 1 
and to return to the PDP-6 ODT from TENLGD, type PS, 

Once you have become accustomed to debugging EUTERPE 

programs, you will probably have occasions when you mill not 
% 

have to actually hear the program to debug ft, In such a case, 
the program does not have to be run on the PDP-6 but can be run 
as a Job on the timesharing system, Suppose you have such a 
program assembled with file name fllenamel BIN* From 
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{timesharing) DDT, create a job by typing! 

Jcbname £$) J 

Next, load the file by typing! 

L fTlenamel_BI Her 

The program may no* be started by typing NGSEX^G, and ft frill 
type out .VALUE Q when It stops* On subsequent occasions. It 
may be started by typing SETUP^p G* 

it Is also possible to ptay a EUTERPE program through 
the Minsky music box hooked Into a terminal which outputs 30 
healthy characters per second* (Noise In either the terminal or 
the line may cause dlsasterous 1 os sage.) This output rate will, 
unfortunately, distort most rhythmic subtleties; but It will 
provide a rough approximation for debugging purposes. To run a 
program In this manner, create a job and load the file, as 
above, and start the program by typing BQX@G* The appropriate 
control characters are transmitted for turning the box on and 
off and silencing and restoring typeout; and these control 
signals alow for breakpoints In the EUTERPE program. Any other 
Intefrputlons, however, may lose In any number of ways* In tM £ 
case, the user may have to supply control chaaeters from the 
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terminal: 


1 one r-casft 

0i 

box 

and 

typeout 

on 

10*e fcase 

a: 

box 

on. 

typeou t 

off 

1 oner-case 

b: 

box 

off r 

t ypeout 

on 
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CGMPIL T NG 

Once one has a debugged version of the program, one may 
compile a much more euphonic performance* This is done in 
HACTRN (rather than in the PDP-6J by creating a job In ITS, 
loading the binary of this debugged version, and starting at the 
address COMPEL (S*e. typing CQMpIL^) G)* The program hill echo 
with an asterisk, thereupon the user prescribes conditions for 
output -- device name, user name, file names* These have the 
following default values: DSKiuser name;MUSIC fit enamel* 

Whlle Et is not reoomended practice. It Is possible to 
take a debuged EUTERPE program directly from the core of the 
POP-6 and compile It* Starting In PDP-f DDT, return to TENLOD, 
type Ctrl I. and than type PDP6 (|)J. Type 3 3 776/ followed by a 
tiXlY* Dump out this core Image using Y, Now proceed as 
above, loading In this dumped file instead of art assembled 
binary. (Any file which Is already loaded In the timesharing 
system, e,g* programs using the Minsky bp* for debugging, may 
also be started at COMM L and need to be dumped only If the user 
wishes to save them.) 
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PLAY 1 KG 


Compiled music Is played by APOLLO which Is loaded by 
typing APQLLO ctrl Ki. Vfhen It Is loaded, APOLLO echoes an 
asterisk unless the PDP-Sj Is not available, In which case It 
flushes Itself. APOLLO commands are analogous to those for 
MUSftUN and aft as follows; 

L Is the command for Loading files. When It Is typed, 
APOLLO echoes with a space, after which the user may type a file 
name. If the file Is not found, APOLLO replies with a question 
mark. Default values are Initially OSS : LUTE RP;M(JS J C OUTPUT, 
but once a file has been loaded. Its specification determines 
default values. However, If only one file name Is given. It Is 
taken as the second; and the first 3s assumed to be MUSIC, 
APOLLO will not only load files compiled by EUTERPE, but also 
those compiled by MUSCOM which were originally Intended to be 
loaded by MUSftUiM, If the file Is completely foreign to APOLLO, 
It will type n CAM*T FIND DATA' 1 followed by another asterisk. If 
the PDP-G Is not running, APOLLO will type a message to that 
effect. If this Is the case, hit INSTRUCTION STOP followed by 
ID RESET, set the address switches to 10D, and hit START* 

If a compiled file Is too large to fit In the PDP-G 
core, APOLLO will toad as much as possible and then type "MORE,* 1 
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To continue after the loaded portion 3s ptayed, type A, If there 
is still too much for one load, another MORE message will be 
given, and so on until all of the file has been digested,. 

P Is the Play command. When it Is typed, the PDP-6 
Starts playing, For this player, the address switches and data 
switches should be set to aero and the amplifier should be set 
to channel aux1. 

$ Is the Stop command. Typing It will cause the POP-6 
to stop pi ay Tug. 

Q Is the qul t corrmand. Typing It ■will flush APOLLO, 

T Is the Tempo command. When It Is typed, APOLLO echoes 
with an equals sign and the tempo constant. If It Is preceded 
by a number, then the tempo constant Is set to that number. (Do 
not type a space between the number and the T*) Files compiled 
by EUTERPE have the tempo constant 

0 15 the Detune command. It Is preceded by a sIk digit 
■% 

octal number which sets the detuning constants for the six 
voices {see A, I, Memo No, 107). 
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? causes APOLLO to 31st these commands. 


The APOLLO player may also he 
switches til the manner described lo A. 


run from the PDF-G 
I, Nemo Ho* 107, 


data 


